SGI Freeware 1999 August

home *** CD-ROM | disk | FTP | other *** search

/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_qt.idb / usr / freeware / catman / p_man / cat3 / qdialog.Z / qdialog

Wrap

Text File | 1998-10-28 | 16.1 KB | 331 lines

QQQQDDDDiiiiaaaalllloooogggg((((3333qqqqtttt)))) TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888)))) QQQQDDDDiiiiaaaalllloooogggg((((3333qqqqtttt)))) NNNNAAAAMMMMEEEE QDialog - The base class of dialog windows SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS #include <qdialog.h> Inherits QWidget. Inherited by QFileDialog, QMessageBox, QPrintDialog and QTabDialog. PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrrssss QQQQDDDDiiiiaaaalllloooogggg (((( QQQQWWWWiiiiddddggggeeeetttt **** _p_a_r_e_n_t====0000,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr **** _n_a_m_e====0000,,,, bbbboooooooollll _m_o_d_a_l ~~~~QQQQDDDDiiiiaaaalllloooogggg () iiiinnnntttt eeeexxxxeeeecccc (((()))) iiiinnnntttt rrrreeeessssuuuulllltttt (((()))) ccccoooonnnnsssstttt vvvviiiirrrrttttuuuuaaaallll vvvvooooiiiidddd sssshhhhoooowwww (((()))) vvvviiiirrrrttttuuuuaaaallll vvvvooooiiiidddd mmmmoooovvvveeee (((( iiiinnnntttt _x,,,, iiiinnnntttt yyyy )))) vvvvooooiiiidddd mmmmoooovvvveeee (((( ccccoooonnnnsssstttt QQQQPPPPooooiiiinnnntttt &&&& pppp )))) vvvviiiirrrrttttuuuuaaaallll vvvvooooiiiidddd rrrreeeessssiiiizzzzeeee (((( iiiinnnntttt _w,,,, iiiinnnntttt hhhh )))) vvvvooooiiiidddd rrrreeeessssiiiizzzzeeee (((( ccccoooonnnnsssstttt QQQQSSSSiiiizzzzeeee &&&& )))) vvvviiiirrrrttttuuuuaaaallll vvvvooooiiiidddd sssseeeettttGGGGeeeeoooommmmeeeettttrrrryyyy (((( iiiinnnntttt _x,,,, iiiinnnntttt _y,,,, iiiinnnntttt _w vvvvooooiiiidddd sssseeeettttGGGGeeeeoooommmmeeeettttrrrryyyy (((( ccccoooonnnnsssstttt QQQQRRRReeeecccctttt &&&& )))) PPPPrrrrooootttteeeecccctttteeeedddd MMMMeeeemmmmbbbbeeeerrrrssss vvvvooooiiiidddd sssseeeettttRRRReeeessssuuuulllltttt (((( iiiinnnntttt rrrr )))) vvvviiiirrrrttttuuuuaaaallll vvvvooooiiiidddd kkkkeeeeyyyyPPPPrrrreeeessssssssEEEEvvvveeeennnntttt (((( QQQQKKKKeeeeyyyyEEEEvvvveeeennnntttt **** )))) vvvviiiirrrrttttuuuuaaaallll vvvvooooiiiidddd cccclllloooosssseeeeEEEEvvvveeeennnntttt (((( QQQQCCCClllloooosssseeeeEEEEvvvveeeennnntttt **** )))) PPPPrrrrooootttteeeecccctttteeeedddd SSSSlllloooottttssss vvvviiiirrrrttttuuuuaaaallll vvvvooooiiiidddd ddddoooonnnneeee (((( iiiinnnntttt )))) vvvvooooiiiidddd aaaacccccccceeeepppptttt (((()))) vvvvooooiiiidddd rrrreeeejjjjeeeecccctttt (((()))) DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The QDialog class is the base class of dialog windows. A dialog window is a widget used to communicate with the user. It offers mechanisms such as default buttons. The dialog window can either be modeless or modal. A modeless dialog is a normal window, while a modal window must be finished before the user can continue with other parts of the program. The third constructor argument must be set to TRUE to create a modal dialog, otherwise it will create a modeless dialog. Example (your own modal dialog): class Modal : public QDialog { Q_OBJECT Page 1 (printed 9/22/98) QQQQDDDDiiiiaaaalllloooogggg((((3333qqqqtttt)))) TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888)))) QQQQDDDDiiiiaaaalllloooogggg((((3333qqqqtttt)))) public: Modal( QWidget *parent, const char *name ); }; Modal::Modal( QWidget *parent, const char *name ) : QDialog( parent, name, TRUE ) { QPushButton *ok, *cancel; ok = new QPushButton( "Ok", this ); ok->setGeometry( 10,10, 100,30 ); connect( ok, SIGNAL(clicked()), SLOT(accept()) ); cancel = new QPushButton( "Cancel", this ); cancel->setGeometry( 10,60, 100,30 ); connect( cancel, SIGNAL(clicked()), SLOT(reject()) ); } Note that the parent widget has a different meaning for modal dialogs than for other types of widgets. A dialog is placed on top of the parent widget. The dialog is centered on the screen if the parent widget is zero. You would normally call exec() to start a modal dialog. This enters a local event loop, which is terminated when the modal dialog calls done() (or accept() or reject()). Example (using a modal dialog): Modal m; if ( m.exec() ) { // ok was pressed, then fetch the interesting dialog data } Modeless dialogs behave just like ordinary widgets. The only difference is that they have the default button mechanism. See also: QTabDialog, QWidget, QSemiModal and GUI Design Handbook: Dialogs, Standard. Examples: xform/xform.cpp MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN QQQQDDDDiiiiaaaalllloooogggg::::::::QQQQDDDDiiiiaaaalllloooogggg (((( QQQQWWWWiiiiddddggggeeeetttt **** ppppaaaarrrreeeennnntttt====0000,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr **** nnnnaaaammmmeeee====0000,,,, bbbboooooooollll mmmmooooddddaaaallll====FFFFAAAALLLLSSSSEEEE,,,, WWWWFFFFllllaaaaggggssss ffff====0000 )))) Constructs a dialog named _n_a_m_e, which has a parent widget _p_a_r_e_n_t. The dialog will by default be modeless, unless you set _m_o_d_a_l to TRUE to contruct a modal dialog. The _f argument is the widget flags, which can be used to customize the window frame style. WWWWaaaarrrrnnnniiiinnnngggg:::: Creating a modeless dialog with a parent makes it Page 2 (printed 9/22/98) QQQQDDDDiiiiaaaalllloooogggg((((3333qqqqtttt)))) TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888)))) QQQQDDDDiiiiaaaalllloooogggg((((3333qqqqtttt)))) an ordinary child widget, which is probably not what you want. Expect strange behavior (QDialog has a default button mechanism). QQQQDDDDiiiiaaaalllloooogggg::::::::~~~~QQQQDDDDiiiiaaaalllloooogggg (((()))) Destroys the QDialog and all its children. vvvvooooiiiidddd QQQQDDDDiiiiaaaalllloooogggg::::::::aaaacccccccceeeepppptttt (((()))) [[[[pppprrrrooootttteeeecccctttteeeedddd ssssllllooootttt]]]] Closes the dialog and sets the result code to Accepted. Equivalent to done(Accepted);. vvvvooooiiiidddd QQQQDDDDiiiiaaaalllloooogggg::::::::cccclllloooosssseeeeEEEEvvvveeeennnntttt (((( QQQQCCCClllloooosssseeeeEEEEvvvveeeennnntttt **** eeee )))) [[[[vvvviiiirrrrttttuuuuaaaallll pppprrrrooootttteeeecccctttteeeedddd]]]] Calls reject() if it is a modal dialog, or accepts the close event if it is a modeless dialog. Reimplemented from QWidget. vvvvooooiiiidddd QQQQDDDDiiiiaaaalllloooogggg::::::::ddddoooonnnneeee (((( iiiinnnntttt rrrr )))) [[[[vvvviiiirrrrttttuuuuaaaallll pppprrrrooootttteeeecccctttteeeedddd ssssllllooootttt]]]] Closes the dialog and sets the result code to _r. Equivalent to calling hide(), then setResult(_r ). This function is very useful for modal dialogs. It leaves the local event loop and returns from the exec() or show() function. WWWWaaaarrrrnnnniiiinnnngggg:::: Although done() will return to the caller if this dialog is modal, the local event loop is then marked for termination. Hence, a program should not try to do anything that depends on event handling before the corresponding exec() or show() has returned. See also: accept() and reject(). iiiinnnntttt QQQQDDDDiiiiaaaalllloooogggg::::::::eeeexxxxeeeecccc (((()))) Starts the dialog and returns the result code. Equivalent to calling show(), then result(). This function is very useful for modal dialogs. It enters a new local event loop. The event loop is terminated when the dialog is hidden, usually by calling done(). vvvvooooiiiidddd QQQQDDDDiiiiaaaalllloooogggg::::::::kkkkeeeeyyyyPPPPrrrreeeessssssssEEEEvvvveeeennnntttt (((( QQQQKKKKeeeeyyyyEEEEvvvveeeennnntttt **** eeee )))) [[[[vvvviiiirrrrttttuuuuaaaallll pppprrrrooootttteeeecccctttteeeedddd]]]] Handles key press events for the dialog. Calls reject() if Escape is pressed. Simulates a button click for the default button if Enter is pressed. All other keys are ignored. Reimplemented from QWidget. Page 3 (printed 9/22/98) QQQQDDDDiiiiaaaalllloooogggg((((3333qqqqtttt)))) TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888)))) QQQQDDDDiiiiaaaalllloooogggg((((3333qqqqtttt)))) vvvvooooiiiidddd QQQQDDDDiiiiaaaalllloooogggg::::::::mmmmoooovvvveeee (((( ccccoooonnnnsssstttt QQQQPPPPooooiiiinnnntttt &&&& pppp )))) Reimplements QWidget::move() for internal purposes. vvvvooooiiiidddd QQQQDDDDiiiiaaaalllloooogggg::::::::mmmmoooovvvveeee (((( iiiinnnntttt xxxx,,,, iiiinnnntttt yyyy )))) [[[[vvvviiiirrrrttttuuuuaaaallll]]]] Reimplements QWidget::move() for internal purposes. Reimplemented from QWidget. vvvvooooiiiidddd QQQQDDDDiiiiaaaalllloooogggg::::::::rrrreeeejjjjeeeecccctttt (((()))) [[[[pppprrrrooootttteeeecccctttteeeedddd ssssllllooootttt]]]] Closes the dialog and sets the result code to Rejected. Equivalent to done(Rejected);. vvvvooooiiiidddd QQQQDDDDiiiiaaaalllloooogggg::::::::rrrreeeessssiiiizzzzeeee (((( ccccoooonnnnsssstttt QQQQSSSSiiiizzzzeeee &&&& ssss )))) Reimplements QWidget::resize() for internal purposes. Examples: pref/pref.cpp vvvvooooiiiidddd QQQQDDDDiiiiaaaalllloooogggg::::::::rrrreeeessssiiiizzzzeeee (((( iiiinnnntttt wwww,,,, iiiinnnntttt hhhh )))) [[[[vvvviiiirrrrttttuuuuaaaallll]]]] Reimplements QWidget::resize() for internal purposes. Reimplemented from QWidget. iiiinnnntttt QQQQDDDDiiiiaaaalllloooogggg::::::::rrrreeeessssuuuulllltttt (((()))) ccccoooonnnnsssstttt Returns the result code of the dialog. vvvvooooiiiidddd QQQQDDDDiiiiaaaalllloooogggg::::::::sssseeeettttGGGGeeeeoooommmmeeeettttrrrryyyy (((( ccccoooonnnnsssstttt QQQQRRRReeeecccctttt &&&& rrrr )))) Reimplements QWidget::setGeometry() for internal purposes. vvvvooooiiiidddd QQQQDDDDiiiiaaaalllloooogggg::::::::sssseeeettttGGGGeeeeoooommmmeeeettttrrrryyyy (((( iiiinnnntttt xxxx,,,, iiiinnnntttt yyyy,,,, iiiinnnntttt wwww,,,, iiiinnnntttt hhhh )))) [[[[vvvviiiirrrrttttuuuuaaaallll]]]] Reimplements QWidget::setGeometry() for internal purposes. Examples: xform/xform.cpp Reimplemented from QWidget. vvvvooooiiiidddd QQQQDDDDiiiiaaaalllloooogggg::::::::sssseeeettttRRRReeeessssuuuulllltttt (((( iiiinnnntttt )))) [[[[pppprrrrooootttteeeecccctttteeeedddd]]]] Sets the result code of the dialog. vvvvooooiiiidddd QQQQDDDDiiiiaaaalllloooogggg::::::::sssshhhhoooowwww (((()))) [[[[vvvviiiirrrrttttuuuuaaaallll]]]] Shows the dialog box on the screen, as QWidget::show() and enters a local event loop if this dialog is modal (see constructor). This implementation also does automatic resizing and automatic positioning. If you have not already resized or moved the dialog, it will find a size that fits the contents and a position near the middle of the screen (or centered relative to the parent widget if any). WWWWaaaarrrrnnnniiiinnnngggg:::: Calling show() for a modal dialog enters a local Page 4 (printed 9/22/98) QQQQDDDDiiiiaaaalllloooogggg((((3333qqqqtttt)))) TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888)))) QQQQDDDDiiiiaaaalllloooogggg((((3333qqqqtttt)))) event loop. The event loop is terminated when the dialog is hidden, usually by calling done(). See also: exec(). Examples: movies/main.cpp xform/xform.cpp Reimplemented from QWidget. SSSSEEEEEEEE AAAALLLLSSSSOOOO hhhhttttttttpppp::::////////wwwwwwwwwwww....ttttrrrroooollllllll....nnnnoooo////qqqqtttt////qqqqddddiiiiaaaalllloooogggg....hhhhttttmmmmllll CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT Copyright 1992-1997 Troll Tech AS. See the LICENSE file included in the distribution for a complete license statement. AAAAUUUUTTTTHHHHOOOORRRR Generated automatically from the source code. Page 5 (printed 9/22/98)